home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / wc3x / catscan3.zip / CATSCAN.DOC < prev    next >
Text File  |  1992-09-27  |  43KB  |  1,088 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                               C A T  S C A N
  12.                        =============================
  13.  
  14.                                  Wildcat!
  15.  
  16.                          A BBS Archive Maintainer
  17.                              And Virus Scanner
  18.                        ============================
  19.  
  20.                            From a Member of the 
  21.                           Wildcat! 3.0 Alpha Team
  22.                           =======================
  23.  
  24.                    Supports Single & Multi-Node Systems
  25.  
  26.                       Release Version 1.1 - 05/15/92
  27.                              (C)opyright 1992
  28.  
  29.                           The Software Connection
  30.                                 Mike Ortiz
  31.                              5237 SW 31st Terr
  32.                              Topeka, KS 66614
  33.  
  34.  
  35.                         The Software Connection BBS
  36.                      (913) 271-2070  USR DS 14400 (Locked)
  37.                      (913) 271-2071  USR DS 16800 (Locked)
  38.                      (913) 271-2072  USR DS 14400 (Locked)
  39.                      (913) 271-2073  USR DS 14400 (Locked)
  40.                      (913) 271-2074  USR HST 14.4 (Locked)
  41.  
  42.                           1200 / 16.8K   24 Hours
  43.  
  44.                              Fido Net  1:281/2
  45.  
  46.                        Magic Freq FileName: CATSCAN
  47.                           For The Latest Version
  48.  
  49.  
  50.                   (913) 271-2079 Voice (6PM-10PM Central)
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                      CATSCAN
  69.                                   =============
  70.  
  71.  
  72.  
  73.                                 Table of Contents
  74.                               =====================
  75.  
  76.      Support of Product..............................................1
  77.      Warranty........................................................1
  78.      Copyright.......................................................1
  79.      Distribution....................................................1
  80.      What Catscan Does...............................................1
  81.      Special Features................................................2
  82.      Setup and Installation..........................................4
  83.      Configuration...................................................5
  84.      Testing the Configuration.......................................9
  85.      Running Catscan as SCANFILE.BAT (.RUN).........................10
  86.      Running Catscan2 as an event...................................11
  87.      Licensing & Distribution Agreement.............................12
  88.      Acknowledgements...............................................13
  89.      Latest known versions of External Programs.....................13
  90.      Most Common Problems...........................................14
  91.      Support BBS's..................................................15
  92.      Special Thanks.................................................15
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                                Support Of Product
  125.                             ========================
  126.  
  127.      I just want to ensure those that decide to register this product that
  128.      transmission of the registered key will be sent promptly or made 
  129.      availible for DOWNLOAD upon receipt of your payment.  I want
  130.      to make it clear that CatScan is supported by me to the best of my
  131.      ability. If you have any problems with CatScan, I will try to solve
  132.      your problem as best as I can and as quick as possible.  If you 
  133.      have problems give me a chance to answer them before you 
  134.      give up on CatScan.  I answer ALL my mail on my system several 
  135.      times a day and if you leave me a message you WILL get an answer.
  136.  
  137.  
  138.  
  139.                                    Warranty
  140.                                 ==============
  141.  
  142.      This product is provided "As Is" without warranty of any kind. The
  143.      entire risk as to the results and performance of the program is
  144.      assumed by you. Furthermore, I the author do not warrant, guarantee,
  145.      or make any representations regarding the use of, or the results of
  146.      the use of the program, and you rely on the program and results solely
  147.      at your own risk.  I the author cannot accept responsibility for
  148.      system damage, loss of profit, or any other special, incidental, or
  149.      consequential damages resulting from the use or inability to use this
  150.      product.
  151.  
  152.  
  153.  
  154.  
  155.                                    Copyright
  156.                                 ===============
  157.  
  158.      CatScan is distributed under the SHAREWARE concept. Under this concept
  159.      you may use the SHAREWARE (unregistered demo) version for a reasonable  
  160.      period of time, which is usually thirty days.  After which you must 
  161.      either register your copy or discontinue usage.
  162.  
  163.  
  164.                                  Distribution
  165.                               ==================
  166.  
  167.      You are free, in fact encouraged, to distribute the SHAREWARE
  168.      (unregistered) version of the CatScan provided that all files
  169.      contained in the original CATSCANx.ZIP archive are distributed in
  170.      their original unmodified state.
  171.  
  172.  
  173.  
  174.  
  175.                                What Catscan Does
  176.                              =====================
  177.  
  178.      Catscan will litterly let the user upload any kind of a file and it
  179.      will check it for integrity, the date of the files in the archive, TD0
  180.      files, Imbedded archives, recursed directories, unwanted files in the
  181.      archive and then if the newly uploaded file is not in the form of your
  182.      default archive it will change it to that form (Should only be used in
  183.      Catscan2 at this time) with out you lifting a finger.
  184.  
  185.      For instance, if an .ARC is uploaded it will be a .ZIP when Catscan2
  186.  
  187.  
  188.      is done.  If a TXT file is uploaded it will be a .ZIP when its done,
  189.      If they Upload a .TD0 file it will be a .ZIP when it's done (If you
  190.      add TD0 to the list in TXTNAMES.TXT). This way the User is not
  191.      returned a message "Sorry you will have to re-upload that 300k LZH you
  192.      just uploaded in .ZIP form" That wastes your time and the users time.
  193.      Why not let Catscan Deal with it..
  194.  
  195.      * Note *
  196.  
  197.      Until Wildcat implements the feature to change the archive
  198.      name on the fly only CatScan2 will allow you to convert files to your
  199.      default archive.  Hopefully it will be added shortly by Mustang.
  200.  
  201.  
  202.                           Special Features of CatScan
  203.                        =================================
  204.  
  205.      o    Checks integrity of uploaded files ZIP, ARJ, PAK, SDN, LZH, and
  206.           ARC. (Others can be added if there is a request).
  207.  
  208.      o    Checks Tele-disk's TD0 files for integrity.
  209.  
  210.      o    Checks Archived files in Archives for All Checks.
  211.  
  212.      o    Scans All files in the Archive for Viruses using the latest
  213.           version of SCAN from McAfee's.
  214.  
  215.      o    Will fail the file if the file dates are earlier than your
  216.           specified date. This also has two different ways to go, CatScan
  217.           will either fail the file if at least one file fails the date
  218.           check, and it will also work in the opposite manner.  Catscan
  219.           will only fail the file if none of the files passes the date
  220.           check, thus giving you all the flexibility to handle things the
  221.           way you want.
  222.  
  223.      o    Will re-archive any archive files that passes all tests with the
  224.           latest archive utility so you are sure it is an up to date
  225.           Archiving method. (This process can also be delayed and run in
  226.           your nightly .BAT file if you so desire).
  227.  
  228.      o    CatScan will convert any archive to a default archive that you
  229.           specify in the configuration.
  230.  
  231.      o    Will strip out other BBS's Authentic Verification and add yours
  232.           (if you have the registered version of PKZIP).  This is to let
  233.           the users know that your system has checked it for viruses if it
  234.           has your -AV on it.
  235.  
  236.      o    CatScan will add your BBS's .ZIP comment to the archive file if
  237.           you so desire (available in .ZIP and .ARJ only).
  238.  
  239.      o    Catscan will read in a .TXT file of file names created by you of
  240.           which it deletes if it finds in any archive. This will rid your
  241.           .ZIP files of the infamous README.COM and thousands of others
  242.           that are popping up.
  243.  
  244.  
  245.      o    CatScan will display current status to the users over the com
  246.           port. Com 1 - 8  are supported with Non-Standard IRQ and base
  247.  
  248.           addresses as well. It gives the user something to watch while
  249.           CatScan is working on the uploaded files.
  250.  
  251.      o    CatScan2 will maintain each directory on your hard drive
  252.           separately.  So New files that you add to the system can have the
  253.           CatScan treatment done to them with out you having to worry about
  254.           them.
  255.  
  256.      o    Catscan2 can operate by it's self on an entire directory, and can
  257.           be used in your nightly .BAT file to maintain all areas on your
  258.           BBS, processing only the files it hasn't processed before.
  259.           (Useful for Wildcat 2.x and 1.x)
  260.  
  261.      o    Easy configuration makes it so you don't have to have multiple
  262.           .CFG files, or a command line that has 6 different options on it
  263.           making it confusing and a pain just to run the program from the
  264.           dos prompt. In fact I write the .CFG into the .EXE file so you
  265.           never have to tell CatScan where to find the .CFG file.
  266.  
  267.      o    Added the RUNLATER.TXT text file that will add the ability to
  268.           process files and compress .gif files in your nightly .BAT file.
  269.           this can be used in several different ways. First, it will only
  270.           compress .GIF files in this way, second if you are running a
  271.           slower machine (XT), then this is a way for you to keep your
  272.           archives up to date with out making your users suffer the time
  273.           required to process a .zip file while they are on-line. 
  274.  
  275.      o    Supports Recursed Directories, and Volume labels of Zip files so
  276.           you won't loose those directories in Archived files.
  277.  
  278.  
  279.      o    CATSCAN2 will update the Wildcat database so If CATSCAN2 changes
  280.           the file to your default archive or converts a GIF then it will
  281.           change the Name and file size of the file (note this is only in
  282.           CATSCAN2).
  283.  
  284.  
  285.      o    CatScan has two different outputs available over the comport.  If
  286.           you are a registered Catscan user then you may take advantage of
  287.           this option.  It will display a rather pretty screen to the user
  288.           and move check marks around the screen while it is processing the
  289.           file. It is really hard to explain, but let me just say that it
  290.           looks very nice...
  291.  
  292.  
  293.      o    Catscan2 will read a ASCII text file of file extensions that
  294.           should be archived using your default archive. This allows you to
  295.           specify that all TXT, LST, and DOC files should be converted to
  296.           .ZIP to save space on your system, and maintain one type of file.
  297.  
  298.  
  299.      o    Catscan2 will convert your .GIF files with either GIF2JPG or
  300.           GIFLITE which ever you prefer.  After CatScan2 has finished, it
  301.           gets the new file size and updates the wildcat database to
  302.           reflect any changes. If you use JPG then it changes the file name
  303.           as well from .GIF to .JPG.
  304.  
  305.  
  306.      o    Ability to Import or Export a configuration so that 
  307.           Upgrading to a newer version is now a snap.  Just export 
  308.           your configuration before overwriteing the old .EXE then 
  309.           import the configuration into the new version.
  310.  
  311.  
  312.                             Setup and Installation
  313.                         ==============================
  314.  
  315.  
  316.      To install CatScan on your system simply copy Catscan.EXE to any dos
  317.      directory with a DOS PATH to it (your \WC30 directory would work).
  318.      Then type in CATSCAN /C (you can do this as many times as you want as
  319.      your configuration may change).  The program will then ask you some
  320.      simple questions, answer them to the best of your knowledge. The first 
  321.      question that will be asked is the [I]mport [E]xport [C]ontinue 
  322.      question. For first time instalations you should pick the continue 
  323.      option to allow you to setup Catscan to your system.  Then After doing 
  324.      that you may run the Catscan /c again and use the export option.  This 
  325.      will allow you to save your configuration to a ASCII TXT file.  Then 
  326.      when new versions of catscan become availible all you will have to do 
  327.      to configure catscan again is import the ascii text file that you have 
  328.      of your configuration.  This makes updateing to a new version simple 
  329.      and painless.  After the configuration is done you can modify some of 
  330.      the files to fit your system. I recommend you run the program with the 
  331.      files I have provided for the first run. When you know the program is 
  332.      working properly then add more files to the BADNAMES.TXT file and 
  333.      setup your zip comment file.  If you want more names added to the 
  334.      BADNAMES.TXT file then use an ASCii editor and add all the filenames 
  335.      you want taken out of the archived files.  BADNAMES.TXT is 
  336.      limited to 150 names in version 1.1 and earlier.  If you want your add 
  337.      put on the .ZIP comments then you may rename your TXT file 
  338.      (advertisement) to ZIP.CMM or just enter your TXT file name in the 
  339.      configuration program.
  340.  
  341.      Catscan contains the following files:
  342.  
  343.           CATSCAN.EXE  - Program used in SCANFILE.BAT
  344.           CATSCAN2.EXE - Program to run in nightly events
  345.           CATSCAN.KEY  - Needed to Run CATSCAN and CATSCAN2
  346.           CATSCAN.DOC  - This File
  347.           RUNLATER.TXT - Sample RUNLATER file
  348.           ZIP.CMM      - Sample ZIP Comments File
  349.           BADNAMES.TXT - Sample BADNAMES.TXT File
  350.           ADDNAMES.TXT - Sample ADDNAMES.TXT File
  351.           TXTNAMES.TXT - Sample file with file extensions.
  352.           SCREEN.SCR   - CatScan's High Graphics display screen (Should be
  353.                          in the same directory as CATSCAN.KEY)
  354.           EXCLUDE.XXX  - How to exclude directoris from being processed
  355.           SCANFILE.BAT - Example SCANFILE.BAT for Multi-Lines
  356.           README.1ST   - Important information you should read if exists
  357.           HISTORY.DOC  - Information on what was added in past versions
  358.  
  359.      In addition to the above, you will need the following files to take
  360.      full advantage of CatScan, these files must exist in the DOS path.
  361.  
  362.           PKZIP.EXE      Zip Archiver
  363.           PKUNZIP.EXE    Zip UnArchiver
  364.           SCAN.EXE       Virus Scanner
  365.           TDCHECK.EXE    TD0 Checker (Tele-Disk Files)
  366.           ARJ.EXE        ARJ Archiver/Un-Archiver
  367.           LHA.EXE        LZH Archiver/Un-Archiver
  368.           PAK.EXE        PAK Archiver/Un-Archiver
  369.           QARC.EXE       ARC Archiver Does all versions of ARC
  370.           XARC.EXE       ARC Un-Archiver Does all versions of ARC
  371.           Giflite or     GIF File Compressor
  372.           GIF2JPG
  373.  
  374.      If you do not have all the unarchivers and would still like to check 
  375.      out the program with the archivers you do have then for the ones you 
  376.      don't have copy pkzip.exe to the name of the archiver your missing and 
  377.      catscan will just think that is ARJ.EXE even though it is PKUNZIP.EXE 
  378.      that has had the name changed.  This is also an effective way to make 
  379.      catscan reject any files of a particular type that you do not wish to 
  380.      have uploaded.  For Example lets say you do not want ARJ files Period!  
  381.      Then if you copy pkunzip.exe to arj.exe when an .ARJ file is uploaded 
  382.      Naturally Pkunzip.exe does not know how to unarchive the ARJ files so 
  383.      it will fail the file because of integrity.
  384.  
  385.      Any of these files can be downloaded from The Software Connection, on
  386.      the first call, no need to get verified, just go to the file directory
  387.      and you will see them all available in the Free Files Area. The entire
  388.      collection are contained in SCANUTIL.ZIP.  For those running D'Bridge,
  389.      Frontdoor, Binkely etc, you may FREQ any of these files by using the
  390.      program's name without the extension; ie; PAK To obtain PAK.EXE,
  391.      SCANUTIL to obtain SCANUTIL.ZIP etc.
  392.  
  393.  
  394.  
  395.  
  396.                              Configuration Program
  397.                          ============================
  398.  
  399.      The configuration program is internal in the .EXE program when you
  400.      modify your configuration you actually modify the data in the .EXE
  401.      file.  This makes it very easy to run the program with less parameters
  402.      on the command line.  Since nothing changes in the configuration it
  403.      makes it easy for you to tailor it to your system.
  404.  
  405.      To run the Configuration program simply type CATSCAN /C  and the
  406.      configuration screen will appear.
  407.  
  408.      * Note *
  409.  
  410.      Whatever appears on the Change From Line is the default.  If you
  411.      desire to accept these defaults, JUST PRESS ENTER.
  412.  
  413.      You will see the following:
  414.  
  415.  
  416.      [I]mport [E]xport, [C]ontinue ?
  417.  
  418.      At this first question if this is a first time installation then you
  419.      will want to select [C]ontinue.  If you are upgrading to a newer version
  420.      then you will want to first [E]xport your configuration from your old
  421.      version then import it into the new version.  This makes upgradeing a
  422.      snap. 
  423.  
  424.  
  425.      Change Your Temp Drive from C:
  426.  
  427.      TO:
  428.  
  429.      Temp Drive -   This is the drive you want Catscan to make a
  430.                     temporary working directory, make sure this drive has
  431.                     enough space to handle your biggest .ZIP file I don't
  432.                     check for drive space right now.  CatScan will remove
  433.                     this directory after its done running. Default is C:
  434.  
  435.  
  436.  
  437.  
  438.      Change Your BADNAMES.TXT From: C:\CATSCAN\BADNAMES.TXT
  439.  
  440.      TO:
  441.  
  442.      BADNAMES.TXT File - This is any .TXT file that has the names of the
  443.                          files you want deleted out of the .ZIP's specify
  444.                          one file per line. Catscan will automatically add
  445.                          this file to the directory you specified or the
  446.                          default, and add COMMAND.COM to it.
  447.  
  448.      Your Log File Drive/Path/First Name Only:  Currently C:\WC30\ACTIVITY
  449.  
  450.      TO:
  451.  
  452.      CatScan Log File - Specify the Drive\Directory\Filename of the
  453.                         file you want to be the log of activity.  If you
  454.                         want it to log to Wildcat!'s activity log then you
  455.                         must specify the drive\path\First part of the
  456.                         filename. In this case the first part would be
  457.                         ACTIVITY since Wildcat!'s logs start with ACTIVITY.
  458.                         If Catscan is run from the DOS prompt it will use
  459.                         the log name then append .000 to the log filename.
  460.  
  461.  
  462.  
  463.  
  464.      Change Your ZIP Comment File From: C:\CATSCAN\ZIP.CMM
  465.  
  466.      TO:
  467.  
  468.      Zip Comment File - This TXT file contains your BBS Advertisement.
  469.                         If you don't want an advertisement put on the .ZIP
  470.                         files then just make this .TXT file empty with 1
  471.                         space.  This file must exist for Catscan to
  472.                         function. This will also remove the old comment.
  473.  
  474.      CATSCAN.KEY is in What Directory: C:\CATSCAN\CATSCAN.KEY
  475.  
  476.      TO:
  477.  
  478.      Ensure that your CATSCAN.KEY is in the directory you specify. and make 
  479.      sure that you put the entire name in the config too.  for example if 
  480.      your catscan.key was in the wc30 dir then the corrent answer to the 
  481.      question would be:  C:\WC30\CATSCAN.KEY
  482.  
  483.      * Note * if for any reason you get the message "Invalid Key" then all
  484.      that is needed is to call one of the five lines listed at the beggining
  485.      of this document for a new key.  The key is 10k and ALWAYS called
  486.      NEWKEY.ZIP on my system.  This file will contain the DOC file for
  487.      Catscan and the most current KEY for operation.  Anyone may get this
  488.      key on their first call just log in then go straight to the file area
  489.      and DOWNLOAD NEWKEY.ZIP.   
  490.     
  491.  
  492.  
  493.  
  494.      RUNLATER.TXT Should Be Put Where   Currently: C:\CATSCAN\RUNLATER.TXT
  495.  
  496.      TO:
  497.  
  498.      The RUNLATER.TXT file is used only for CatScan2 to know what files 
  499.      were uploaded to your system for the day, so in the nightly bat file 
  500.      when you run Catscan2 it will read and process every file that is in 
  501.      this txt file.  I can also be used in conjuncion with BUILDCAT.ZIP 
  502.      (Availible on the support BBS)  and process any give files using 
  503.      wildcards.  For example, say you have a directory of 100 .ZIP's and 10 
  504.      ARJ's and you want to conver the ARJ's to ZIP's then you could process 
  505.      *.ARJ using Buildcat and it will create the Runlater.txt file with 
  506.      those files in it then you just run Catscan2 and it will process only 
  507.      those files. 
  508.  
  509.  
  510.      
  511.      The next 5 sets of questions are going to ask you to define your 
  512.      archivers the first part is the name, include the name and extension. 
  513.      If you want to use the archiver that is the default then just press 
  514.      enter on the name and CatScan and CatScan2 will search your DOS PATH 
  515.      for you and return the location of the file.
  516.  
  517.      You can also specify excatly where Catscan and Catscan2 should look 
  518.      for the archivers even if they are not in the DOS path just type in 
  519.      the full path and filename and if Catscan find the file in the 
  520.      specified directory then it wont go out and search the DOS PATH.  This 
  521.      is usefull especially right now I use the PKUNZIP ver 1.93 to 
  522.      unarchive the archives and PKZIP 1.10 to Archive them since the 2.0 
  523.      version of PKZIP is not realeased yet but we are still receiveing 
  524.      files that have been archived with this version.  The only way to 
  525.      uncompress them is with that version.  The second part asks for the 
  526.      parameters to make the archiver uncrunch and crunch the files.
  527.  
  528.  
  529.      Define your ZIP Archiver :  PKZIP.EXE
  530.  
  531.      TO :
  532.  
  533.      What are the params: -r -p (For people with -AV use -! -r -p)
  534.  
  535.      TO:
  536.  
  537.      Define your ZIP Un-Archiver: PKUNZIP.EXE
  538.  
  539.      TO:
  540.  
  541.      What are the params: -o -d
  542.  
  543.      TO:
  544.  
  545.      Define your LZH Archiver :  LHA.EXE
  546.  
  547.      TO :
  548.  
  549.      What are the params: a
  550.  
  551.      TO:
  552.  
  553.      What are the params to Un_ARC: e
  554.  
  555.      TO:
  556.  
  557.      Define your ARC Archiver: QARC.EXE
  558.  
  559.      TO:
  560.  
  561.      What are the params: a
  562.  
  563.      TO:
  564.  
  565.  
  566.  
  567.      Define your ARC Un-Archiver :  XARC.EXE
  568.  
  569.      TO :
  570.  
  571.      What are the params: /o
  572.  
  573.      TO:
  574.  
  575.      Define your PAK Archiver: PAK.EXE
  576.  
  577.      TO:
  578.  
  579.      What are the params: a
  580.  
  581.      TO:
  582.  
  583.      What are the params to Un-Pack: e
  584.  
  585.      TO:
  586.  
  587.      Define your ARJ Archiver: ARJ.EXE
  588.  
  589.      TO:
  590.  
  591.      What are the params: a
  592.  
  593.      TO:
  594.  
  595.      What are the params to Un-ARC: e
  596.  
  597.      TO:
  598.  
  599.  
  600.      Should I write GIF files to the RUNLATER.TXT file to compress them in
  601.      your nightly .BAT file:  NO
  602.  
  603.      (Y/N)
  604.  
  605.      What is the oldest date in the Archive to Pass: 01/01/80
  606.  
  607.      Change Month to:
  608.  
  609.      Change Day to:
  610.  
  611.      Change Year to:
  612.  
  613.  
  614.      Should I fail the file If just some of the files are older than the 
  615.      date specified (Y/N) ? NO
  616.  
  617.      This option might be one of the more confusing questions in the 
  618.      configuration.  What it means is that some programs use the same data 
  619.      files or DOC files but the program themselves have been updated. In 
  620.      cases like this you wouldn't want to fail the file because the program 
  621.      itself passes your date scan.  If this is the type of operation you 
  622.      desire then set this option to NO.  If you want to be as strict as 
  623.      possible then set this option to YES.
  624.  
  625.                                                                                                                                          
  626.      if you don't want the feature enabled then leave it at 01/01/80  and 
  627.      catscan will not check the date in the archive.  Setting it to 
  628.      anything before 01/01/80 will cause Catscan to use the year 2000 
  629.      instead of 1900 so don't.
  630.  
  631.           ie. year 79 is 2079
  632.  
  633.  
  634.  
  635.  
  636.      Do you want ZIP files that had nothing deleted from them displayed in
  637.      the log: YES
  638.  
  639.      (Y/N)
  640.  
  641.      This option is a little strange but I saw a need for it.  If you get a
  642.      lot of files from a BBS that had advertisement TXT files, then you may
  643.      want this option enabled. It will help you catch BBS advertisements
  644.      that may be in the archives. This will then allow you to add those
  645.      names to your BADNAMES.TXT file. If the majority of your uploaded
  646.      files don't have advertisements in them then you may not want to use
  647.      the option.
  648.  
  649.  
  650.      Do you want me to put your comment on the file at the time of the 
  651.      upload (Only works for ZIP and ARJ) (Y/N)? Yes
  652.  
  653.      Do you want me to write all archives to the RUNLATER.TXT file so that 
  654.      Catscan2 can process them in your nightly BAT file? (Y/N): YES
  655.  
  656.      (Y/N) : Y
  657.  
  658.  
  659.  
  660.      Settings for Catscan2 are the same as Catscan except for the following 
  661.      questions.
  662.  
  663.  
  664.      Should I move files that fail for any reason to a BAD directory 
  665.      (Y/N) : No
  666.  
  667.  
  668.      This option is pretty much up to you on how you want to handle it. I 
  669.      personally dont move the files, because if there is something wrong 
  670.      with the file Catscan would have already cought it at the time of the 
  671.      upload.  However those processing a directory by itself then you may 
  672.      want any of the bad files moved out of that directory,  but Catscan2 
  673.      logs any failed files in the LOG file like ACTIVITY.000 if a file 
  674.      passes so you could then review that log as well and see if any files 
  675.      failed..  Its your choice.
  676.  
  677.      People Using wildcat ver 2.x or another BBS program will want to say 
  678.      YES to this option since Catscan will not be able to flag the file as 
  679.      BAD in the BBS Database.  (It will only do this for ver 3.x of 
  680.      Wildcat!)
  681.  
  682.      If You answer No to the above question then the question below will
  683.      not be asked.
  684.  
  685.      Change Your Bad File Dir From: C:\BAD
  686.  
  687.      TO:
  688.  
  689.      BadFileDir - This is a Drive\Directory of the place CatScan2 will put
  690.                   files that either failed any tests or have a virus. Makes
  691.                   it easy to see if any action has come up.  Catscan2 will
  692.                   automatically create this directory for you if it does
  693.                   not already exist.
  694.  
  695.  
  696.      What Is Your Default Archiver   Currently selected: 1
  697.  
  698.      1 - ZIP
  699.      2 - LZH
  700.      3 - ARC
  701.      4 - PAK
  702.      5 - ARJ
  703.  
  704.      Change it To:
  705.  
  706.      This tells Catscan2 What Default archive type you prefer to have all 
  707.      your archives converted to.
  708.  
  709.      Do you want me to convert all Archives to your default Archive: NO
  710.  
  711.      (Y/N)
  712.  
  713.      Answering No to this question will tell catscan not to convert any 
  714.      files over to a different type archive format.  Catscan2 will still 
  715.      process the file and rearchive it but it will remain in its original 
  716.      archiver format.
  717.  
  718.  
  719.      Should I Just scan the file and not touch it in any way? 
  720.      (Answering Yes will leave anyone's -AV intact): NO
  721.  
  722.      (Y/N)
  723.  
  724.      This feature would manly be used to just scan an entire directory for 
  725.      viruses and integrety.  For example if you just aquired Catscan and 
  726.      want to have it check all your existing archives for viruses or 
  727.      integrity then set this question to YES and thats what it will do..  
  728.      If you want it to recompress the file with the latest archiver and 
  729.      Scan and check for integrity then this question must be set to NO
  730.      
  731.  
  732.  
  733.  
  734.                            TESTING THE CONFIGURATION
  735.                           ===========================
  736.  
  737.      At this point the configuration is completed and you are ready to test
  738.      the program out.  Make a temp directory and copy a couple .ZIP files
  739.      to that directory then type in CATSCAN C:\TEST\FILENAME.ZIP.  
  740.  
  741.      Some examples might look like this:
  742.  
  743.      * Note *
  744.  
  745.      CATSCAN does one file at a time, CATSCAN2  will do a directory.
  746.  
  747.      CATSCAN C:\TEMP\TESTFILE.ZIP (Processes the file TESTFILE.ZIP)
  748.      CATSCAN G:\UPLOADS\MYFILE.ZIP
  749.      CATSCAN D:\WC30\UPLOADS\THISFILE.ARJ
  750.  
  751.      Example CATSCAN2 parameters
  752.  
  753.      CATSCAN2 C:\TEMP  (Process the Temp directory on C:)
  754.      CATSCAN2 H:\UPLOADS (Process the Uploads dir on H:)
  755.      CATSCAN2 D:\WILDCAT\UPLOADS\TEMP
  756.      CATSCAN2 \TEMP (Process the TEMP dir on the current Drive)
  757.      CATSCAN2 Will process all files out of the RUNLATER.TXT file
  758.      CATSCAN2 C:\UPLOADS\MYFILE.ZIP Process just that file.
  759.  
  760.      If the program works fine then you have installed it correctly if
  761.      there is a problem then check to make sure all the files you specified
  762.      in the configuration options are where you said they are.
  763.  
  764.      Make sure that the BADNAMES.TXT has at least one file in it, I put
  765.      COMMAND.COM in there because this is one filename no one needs
  766.      duplicates of.  Make sure you specify a filename for the .ZIP comment
  767.      even if its contents are empty. If the above works fine then you are
  768.      ready to put it on-line for your users to begin using.
  769.  
  770.      We now know that the program is set up fine, and it is in our DOS PATH
  771.      so we don't need to do anything except make the SCANFILE.RUN or .BAT
  772.      file to run the program.
  773.  
  774.  
  775.  
  776.                      RUNNING CATSCAN AS SCANFILE.BAT(RUN)
  777.                     ======================================
  778.  
  779.      If you are running a multi node or single node system then you can
  780.      just use the SCANFILE.BAT to run all your nodes with.  The following
  781.      is the format.
  782.  
  783.           SCANFILE.BAT  (This file goes in your Wildcat directory)
  784.           ------------
  785.           CD \WC30\WCWORK\NODE%WCNODEID%
  786.           CATSCAN %1
  787.  
  788.      One thing to make sure of with this configuration is that If you are
  789.      running a single line version the only way for the above method to
  790.      work is if you have used the SET option in your bat file that calls up
  791.      wildcat.  For example  you must have had this line in your .bat file
  792.      that started wildcat.
  793.  
  794.      SET WCNODEID=1  (The 1 Means Node 1, 2 would mean Node 2 ect...) Also
  795.      multi line versions will have to define this variable for each node.
  796.      It can't be left off of any of them.
  797.  
  798.      For Single line versions that don't want to define the environment
  799.      variable then you can use the SCANFILE.RUN located in the node1
  800.      directory to run catscan.  it would look like this..
  801.  
  802.           SCANFILE.RUN   (Located in the WC30\WCWORK\NODE1 directory)
  803.           ==============
  804.           CD \WC30\WCWORK\NODE1
  805.           CATSCAN %1
  806.  
  807.      Or you can also use the SCANFILE.BAT and just use the same contents as 
  808.      the above example.
  809.  
  810.  
  811.  
  812.  
  813.  
  814.                          RUNNING CATSCAN2 AS AN EVENT
  815.                         ==============================
  816.  
  817.      CATSCAN2.EXE will run in your nightly BAT file and compress any newly
  818.      uploaded .GIF files to either JPG or GifLite your choice. It will
  819.      process your archives if you told CatScan to process the archives in
  820.      your nightly BAT file.  It will Process files from either the
  821.      RUNLATER.TXT file or from the directory passed on the command line, or
  822.      even just one File.  CATSCAN.DAT is only used if you put a directory
  823.      on the command line.  This will allow you to keep a directory in order
  824.      or to just update them.  The following are examples of how it works..
  825.  
  826.           CATSCAN2 C:\UPLOADS (Process the upload directory and
  827.                               create CATSCAN.DAT to know where
  828.                               CatScan2 Left off)
  829.  
  830.           CATSCAN2 C:\UPLOADS\NEWFILE.ZIP (Process only the file
  831.                                            NEWFILE.ZIP in the
  832.                                            upload Directory)
  833.  
  834.           CATSCAN2   (Catscan2 expects to find the RUNLATER.TXT
  835.                       file where it was specified in the config
  836.                       then it will process all the files in the
  837.                       RUNLATER.TXT file)
  838.  
  839.  
  840.  
  841.  
  842.  
  843.                     Explanation of Command Line Parameters
  844.                  ============================================
  845.  
  846.      FileName       This option tells CatScan or Catscan2 that you are
  847.      or             going to be providing it with the Drive/Path/Filename
  848.      %1             of the file that you want to be checked.  It also
  849.                     disables any Delays in the program. (BBS/Stand Alone
  850.                     Option)
  851.  
  852.  
  853.      Dir            This option will tell CatScan2 to process an entire
  854.      or             directory. Note that you put the directory name here
  855.      \UPLOADS       not DIR.  The Dir name must be a complete Drive\Path
  856.                     unless you want the DIR on the current drive to be
  857.                     processed then just the Path is needed.  If CatScan has
  858.                     never run in that Directory, then it will process every
  859.                     .ZIP file in there. If it has run in that directory it
  860.                     will only process the .ZIP files with a date later than
  861.                     when CatScan last ran.  CatScan Creates the file
  862.                     CATSCAN.DAT in the directory after it runs.  This lets
  863.                     CATSCAN know when the last time it ran in a particular
  864.                     directory. (Stand Alone Option)
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.                  CatScan LICENSING AND DISTRIBUTION AGREEMENT
  875.                 ==============================================
  876.  
  877.  
  878.      You may not incorporate parts of CatScan into other programs with out
  879.      written permission from Mike Ortiz Permission may or may not be
  880.      granted based upon a determination of how your intended use.
  881.  
  882.      You must keep this License Agreement intact and give any other
  883.      recipients of the CATSCANx.ZIP program a copy of this License
  884.      Agreement along with the program.
  885.  
  886.      Catscan is still in the process of being completed, but is a very
  887.      functional piece of software as it is. You should be aware that if you
  888.      register you will receive the final version of Catscan 1.0 with no
  889.      additional cost to you. If you choose for me to mail you a disk then a
  890.      disk will be mailed at the time 1.0 is completed.  I don't see any
  891.      reason to mail Beta versions out to people who expect a nice looking
  892.      disk and completed piece of software.  If you like the direction that
  893.      catscan is going then Please send in your registration to help support
  894.      my efforts in this project.
  895.  
  896.  
  897.                                Special Offer
  898.                           =======================
  899.  
  900.      Don't be fooled by clones of Catscan there is still to this date no
  901.      utility that does what catscan does for Wildcat. CatScan will update
  902.      your Wildcat database for you, eliminating one of the most time
  903.      consuming processes for the SysOp.  Writes Activity out the Serial
  904.      port so the users can see what is happening, instead of just a blank
  905.      screen. Finally it converts archives to a default archive and
  906.      compresses GIF files in two different ways make sure another utility
  907.      does this before you compromise options for price.  As an added
  908.      benefit I am giving free access to my BBS to any registered users of
  909.      Catscan.  The Software Connection can be used for Support on Catscan,
  910.      Wildcat 3.0, and any Utilities for 3.0,  I Have 5 lines Locked at 19.2 
  911.      See the Begining of this document to see which line will fit you best. 
  912.      The Support System has roughly 6.5 gigs Of Space, over 45,000 files, 
  913.      Lots Of Wildcat Utilities and Doors.  So With your registration you 
  914.      not only get a good program but great place for support, questions, 
  915.      and plenty of files to post on your own BBS.  All have been scaned 
  916.      With CATSCAN.  Who else does or can offers you type of deal?
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.      Acknowledgements:
  924.  
  925.      o    Wildcat! (tm)  (c) Mustang Software, Bakersfield, CA.
  926.  
  927.      o    These programs were written using Turbo Pascal 6.0 from
  928.           Boreland International, Scotts Valley, CA.
  929.  
  930.      o    SCAN (c) 1989-1992 by McAfee Associates.
  931.  
  932.      o    PkPak, PkUnPak, PkZip (tm), and PkUnZip (tm) (c)
  933.           1986-1992  by Philip W. Katz, PKWARE Inc.
  934.  
  935.      o    LHarc and LHA (c) 1988-1989 by Haruyasu Yoshisaki.
  936.  
  937.      o    Pak (c) 1988-1989 by NoGate Consulting.
  938.  
  939.      o    Arj (c) 1990-1992 by Robert K. Jung.
  940.  
  941.      o    Qarc and Xarc (c) 1990 System Enhancement Associates
  942.  
  943.      o    TDCheck (c) 1990  by Sydex Inc.
  944.  
  945.      o    GifLite (c) 1991 by Tsung Hu
  946.  
  947.      o    Gif2JPG (c) 1990-1991 by Handmade Software Inc.
  948.  
  949.  
  950.  
  951.  
  952.      Latest Known Versions of External Programs are:
  953.  
  954.      Compressed File    Version   Exe File      Explanation
  955.      --------------     -------   ------------  ----------------------
  956.      SCANV89B.ZIP          89B    SCAN.EXE      Virus Scan Program
  957.                                                 by McFee
  958.      ARJ230.EXE           2.30    ARJ.EXE       Process *.arj files
  959.      LH113C.EXE           1.13c   LHARC.EXE     Process *.lzh files
  960.      LHA212.EXE           2.12    LHA.EXE       Process *.lzh files
  961.      PAK251.EXE           2.51    PAK.EXE       Process *.pak & *.sdn
  962.                                                 files
  963.      QARC.EXE             1.0     QARC.EXE &
  964.                                   XARC.EXE      Process *.arc files
  965.      PKZ110.EXE           1.10    PKZIP.EXE &
  966.                                   PKUNZIP.EXE   Process *.zip files
  967.      TDCHECK.ZIP           1.1    TDCHECK.EXE   Test TD0 files for
  968.                                                 integrity
  969.      GIF2JPG.ZIP           1.5    Gif2JPG.EXE &
  970.                                   JPG2GIF.EXE   Compress Gif files
  971.      GIFLITE.ZIP           1.4    GIFLITE.exe   Compress Gif files
  972.  
  973.  
  974.  
  975.  
  976.                              Most Common Problems
  977.                       ===================================
  978.  
  979.  
  980.      Q:   Catscan runs so fast it doesn't seem like it does anything?
  981.  
  982.      A:   Make sure your SCANFLE.BAT file reads like the above example
  983.           CatScan does not use /S or /F in the command line.
  984.  
  985.  
  986.      Q:   I Get a run time error 5 when the program starts to run.
  987.  
  988.      A:   Make sure you have filenames listed in the config. For example,
  989.           you might have left of the CATSCAN.KEY on the question Where is
  990.           your .KEY file.  It Should look something like this:
  991.           C:\DOS\CATSCAN.KEY (not you might have left CATSCAN.KEY off).
  992.           This needs to be done for several of the config questions like;
  993.           BADNAMES.TXT, CATSCAN.KEY, TXTNAMES.TXT, RUNLATER.TXT.
  994.  
  995.      Q:   Catscan does not show on the remote computer, it just says
  996.           Scanning/Checking file.
  997.  
  998.      A:   Catscan could not find DOOR.SYS  make sure that you are changing
  999.           to a node home directory before you start up Catscan. If Catscan
  1000.           can find DOOR.SYS then it will automaticly go out the com port.
  1001.           If you use the %WCNODEID% variable to change to the node home
  1002.           directory make sure that you have defined that varible to the
  1003.           corrent node id.  To verify that it is set correctly type in SET
  1004.           at the Dos prompt and it will show you what its value is. If it
  1005.           doesn't appear then it hasnt been set.  You should see WCNODEID=
  1006.           the number of the node your currently working on.
  1007.  
  1008.      Q:   Catscan works fine on my com1 and com2 line but locks up on my
  1009.           com3 line.
  1010.  
  1011.      A:   You need to setup the %WCIRQID% and the %WCBASEID% environment
  1012.           variables.  You are running nonstandard IRQ and Base address on
  1013.           your comport so this is how you tell Catscan which ones to use.
  1014.           It should be set up anyway for wildcat to run correctly unless
  1015.           the node that is running it is getting it's values from makewild,
  1016.           in which case you must set these varibles anyway just for catscan
  1017.           and some doors.
  1018.  
  1019.  
  1020.      Q:   Catscan is not marking the file as failed when it runs into a
  1021.           failed file.  It says failed in the log but wildcat still says
  1022.           passed..
  1023.  
  1024.  
  1025.      A:   Your not running Catscan from the node home directory.  IE.
  1026.           \wc30\wcwork\node1  look at the example SCANFILE.BAT inculded in
  1027.           the catscan archive.
  1028.  
  1029.  
  1030.       Q:  I get the Message "Invalid Key or KEY Expired"!
  1031.  
  1032.       A:  * Note * if for any reason you get the message "Invalid Key" then 
  1033.           all that is needed is to call one of the five lines listed at the 
  1034.           beggining of this document for a new key.  The key is 10k and 
  1035.           ALWAYS called NEWKEY.ZIP on my system.  This file will contain 
  1036.           the DOC file for Catscan and the most current KEY for operation.  
  1037.           Anyone may get this key on their first call just log in then go 
  1038.           straight to the file area and DOWNLOAD NEWKEY.ZIP.   
  1039.  
  1040.  
  1041.  
  1042.  
  1043.      Support BBS's
  1044.      -----------------------------
  1045.  
  1046.      The Software Connection BBS
  1047.      Fido: 1:281/2   Freq: CATSCAN
  1048.      (913) 271-2070  USR DS  14400  (LOCKED)
  1049.            271-2071  USR DS  16800  (LOCKED)
  1050.            271-2072  USR DS  14400  (LOCKED)
  1051.            271-2073  USR DS  14400  (LOCKED)
  1052.            271-2074  USR HST 14400  (LOCKED)
  1053.            (USA)
  1054.  
  1055.      The City Limits BBS
  1056.      Fido: 1:130/202 Freq: CATSCAN
  1057.      (817) 589-2118  HST 14400 (LOCKED)
  1058.            595-1634  2400 Baud
  1059.            (USA)
  1060.  
  1061.      The SPooK BBS
  1062.      Fido: 2:440/18   Freq: CATSCAN
  1063.            44-268-767365  HST (LOCKED)
  1064.            (ENGLAND)
  1065.  
  1066.  
  1067.  
  1068.                                 Special Thanks
  1069.                          ============================
  1070.  
  1071.      Special thanks go to Scott Green for helping me in many ways make
  1072.      CatScan what it is today. Derek Koopowitz for his great help to me on
  1073.      how to update the Wildcat database.  Robert Warren for making the
  1074.      graphics screen displayed to the User while catscan runs. The Wildcat
  1075.      Alpha team for their initial support in the program and desire to see
  1076.      something good for Wildcat.  The Wildcat Beta team for not flaming me
  1077.      to death on some of the bugs they found.  And a very special thank you
  1078.      to all of those who have already sent in their registrations I guess a
  1079.      good utility speaks for it's self in registrations my mailbox has not
  1080.      been empty except for Sundays.
  1081.  
  1082.      Thank you all Very Much.
  1083.  
  1084.  
  1085.                                   Mike Ortiz
  1086.  
  1087.  
  1088.